home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / autolog.arc / AUTOLOG.DOC next >
Text File  |  1990-01-05  |  14KB  |  521 lines

  1. «RM80»
  2.  
  3.  
  4.                                      AUTOLOG
  5.  
  6.  
  7.  
  8.                                Version 1.00 Manual
  9.  
  10.  
  11.  
  12.                       Copyright (c) 1990 by David A. Seidel
  13.                               All rights reserved.
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.         
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65. -----------------------------------------------------------------
  66.         AUTOLOG                                                    Page 1         Overview/Features
  67.         -----------------
  68.  
  69.         AUTOLOG is a Telix utility program that builds SALT scripts for
  70.         automatic logging onto bulletin board and other on-line systems.
  71.  
  72.         While there exist other similar programs for Telix, AUTOLOG goes
  73.         a bit further.  Here are some of AUTOLOG's features:
  74.         ∙   You can run AUTOLOG either with Alt-G or by linking it to a
  75.             directory entry.
  76.         ∙   AUTOLOG takes the name of the logon script file it creates
  77.             directly from the name of the directory entry.
  78.         ∙   You can take a "snap-shot" of any on-line prompt.
  79.         ∙   You can record single-character responses (including Ctrl-C),
  80.             as well as longer responses, even ones that don't end by
  81.             pressing ENTER.
  82.         ∙   Once you have finished recording prompts and responses, you
  83.             can make AUTOLOG suspend operation until you go off-line.
  84.             Then, AUTOLOG will automatically update the dialing direc-
  85.             tory, making the new logon script the linked script for the
  86.             entry.  After that, AUTOLOG actually compiles the script.
  87.             You don't have to do any more--you're set up for automatic
  88.             logon next time you call the number.
  89.         ∙   AUTOLOG keeps track of how much time elapses between prompts,
  90.             which means that an accurate logon script is created.
  91.         ∙   If you have your sound turned off, logon scripts generated by
  92.             AUTOLOG display a "visual bell" on connection.
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.         
  125.  
  126.  
  127.  
  128.  
  129.  
  130. -----------------------------------------------------------------
  131.         AUTOLOG                                                    Page 2
  132.         Included Files
  133.         --------------
  134.  
  135.         These are the files that are included in the AUTOLOG archive:
  136.  
  137.         AUTOLOG.SLC             The compiled AUTOLOG program.
  138.  
  139.         AUTOLOG.DOC             This file.
  140.  
  141.         VBELL.SLT               A utility that provides a visual "ring"
  142.                                 for phone connections, for those who like
  143.                                 to keep the sound off.
  144.  
  145.         VBELL.SLC               Compiled version of above.
  146.  
  147.  
  148.  
  149.         Installation
  150.         ------------
  151.  
  152.         Just copy AUTOLOG.SLC, VBELL.SLC, and VBELL.SLT into your Telix
  153.         script directory.  The Telix SALT compiler, CS.EXE, must be
  154.         either in the directory from which you run Telix, or (preferably)
  155.         in your PATH.
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.         
  191.  
  192.  
  193.  
  194.  
  195.  
  196. -----------------------------------------------------------------
  197.         AUTOLOG                                                    Page 3         Starting AUTOLOG -- Option 1
  198.         ----------------------------
  199.  
  200.         The first way to start AUTOLOG is to press Alt-G, type "autolog"
  201.         and press ENTER.  After the opening message, you will be prompted
  202.         for the number of the directory entry to dial.  Type the entry
  203.         number and press ENTER.
  204.  
  205.         If you press ESC, press ENTER while the field is empty, or type
  206.         an invalid entry number, AUTOLOG will abort.
  207.  
  208.         If the entry you want to dial has no name, you will be prompted
  209.         for the name to use for the new logon script.  You can type up to
  210.         eight characters (no extension).  You can use any legal DOS file
  211.         name.  Press ENTER to continue.
  212.  
  213.         See "Using AUTOLOG" for what to do next.
  214.  
  215.  
  216.         Starting AUTOLOG -- Option 2
  217.         ----------------------------
  218.  
  219.         The other way to start AUTOLOG is to link it to the directory
  220.         entry for which you want to generate a logon script.  (Press Alt-
  221.         D, select the entry, press 'e' for (E)dit, press ENTER until you
  222.         get to the "Linked script" field, type "autolog", then press
  223.         ENTER until the editing window is gone.) Then (D)ial the number.
  224.  
  225.         Once the connection has been made, AUTOLOG will proceed, unless
  226.         the entry has no name.  In that case, you will be prompted for
  227.         the name to use for the new logon script.  You can type up to
  228.         eight characters (no extension).  You can use any legal DOS file
  229.         name.  Press ENTER to continue.
  230.  
  231.         See "Using AUTOLOG" for what to do next.
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.         
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261. -----------------------------------------------------------------
  262.         AUTOLOG                                                    Page 4         Using AUTOLOG
  263.         -------------
  264.  
  265.         AUTOLOG displays status messages on Telix's status line.  Once
  266.         on-line, AUTOLOG essentially has four operating "states," each of
  267.         which has its own status message and its own special keys.  The
  268.         message displayed always tells you what state AUTOLOG is in and
  269.         what special keys are valid at that moment.  AUTOLOG makes a
  270.         noise whenever the state changes.  These are the messages, with
  271.         explanations of what to do when you see them:
  272.  
  273.         "Dispaying: press ESC to quit"
  274.  
  275.             AUTOLOG is just displaying whatever is coming in over your
  276.             modem.  It will do this until there is a pause, or until the
  277.             on-line program waits for input.  If you press ESC, AUTOLOG
  278.             will suspend operation until you go off-line.
  279.  
  280.         "Waiting: press INS, SPACE, or ESC"
  281.  
  282.             The on-line program has either paused for ten seconds or
  283.             more, or is waiting for you to type something.  You have
  284.             three choices here:
  285.             ∙   If a response is expected, press INS to record the
  286.                 prompt.   This brings you to the "Recording prompt"
  287.                 state, below.
  288.             ∙   If the on-line program is just pausing, press SPACE to
  289.                 display more.  This brings you back to the "Displaying"
  290.                 state.  If the on-line program pauses a lot, you may have
  291.                 to repeat this step a few times.
  292.             ∙   If the on-line program is pausing, and you have already
  293.                 recorded everything you need to log on, press ESC.
  294.                 AUTOLOG will suspend operation until you go off-line.
  295.  
  296.         "Recording prompt"
  297.  
  298.             AUTOLOG is recording the on-line program's prompt.  This is
  299.             pretty fast, so the message will only appear briefly.  This
  300.             brings you to the next state, below.
  301.  
  302.         "Recording you: press END when done"
  303.  
  304.             The on-line program expects you to type something and you
  305.             have just recorded the prompt.  Just type whatever you have
  306.             to type, including ENTER, if necessary.  If the on-line
  307.             program wants a single character, an ESC or a Ctrl-C, that's
  308.             OK too.
  309.  
  310.             **IMPORTANT** -- When you have typed your complete response,
  311.             press END.  Your response will not be sent to the on-line
  312.             program until you do so.  Afterward, AUTOLOG will return to
  313.             the "Displaying" state.
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.         
  322.  
  323.  
  324.  
  325.  
  326. -----------------------------------------------------------------
  327.         AUTOLOG                                                    Page 5         Using AUTOLOG (cont'd)
  328.         ----------------------
  329.  
  330.         So, this is the basic sequence once you're on-line:
  331.  
  332.           1)    Let the program display, pressing SPACE if necessary,
  333.                 until you see a prompt that you have to respond to.  If
  334.                 you've finished recording everything you need to log on,
  335.                 press ESC.
  336.           2)    Press INS to record the prompt.
  337.           3)    Type your response and press END.
  338.           4)    Repeat from step 1.
  339.  
  340.         That's it!
  341.  
  342.         When you go off-line, this is what AUTOLOG does:
  343.  
  344.           1)    A backup copy is made of the phone directory (i.e.,
  345.                 TELIX.FON is copied to TELIX.BAK).
  346.           2)    The phone directory entry for the number you called is
  347.                 modified so that the logon script that AUTOLOG wrote is
  348.                 linked to that entry.
  349.           3)    The phone directory is reloaded.
  350.           4)    The new logon script is compiled.
  351.  
  352.         AUTOLOG prints messages on the screen to confirm the success or
  353.         failure of each of these steps.  Error messages always start with
  354.         "***".
  355.  
  356.  
  357.         Things To Know
  358.         --------------
  359.  
  360.         ∙   When AUTOLOG is in the "Displaying" state, things are dis-
  361.             played on the screen slower than they would otherwise.  This
  362.             should not cause any problems, except possibly when display-
  363.             ing very complex full-screen ANSI pictures at 2400 baud, in
  364.             which case these may be too much input for AUTOLOG to handle.
  365.             If this occurs, try logging in at a slower baud rate with
  366.             AUTOLOG.  I use AUTOLOG at 2400, and I have rarely have any
  367.             problems.  However, I can't guarantee that AUTOLOG will work
  368.             properly at speeds above 2400 baud.  In any case, once you
  369.             suspend AUTOLOG by pressing ESC, Telix takes over the screen
  370.             display again, and everything comes back up to speed.
  371.  
  372.         ∙   If you don't like the sound that AUTOLOG makes when it
  373.             changes states, just use the Alt-O menu to turn sound off in
  374.             Telix.
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.         
  389.  
  390.  
  391. -----------------------------------------------------------------
  392.         AUTOLOG                                                    Page 6         AUTOLOG Logon Scripts
  393.         ---------------------
  394.  
  395.         A few notes about the scripts generated by AUTOLOG:
  396.  
  397.         ∙   When AUTOLOG creates a logon script, it uses the first word
  398.             in the name of the entry being called (if there is a name
  399.             there); if the word is longer than 8 characters, only the
  400.             first 8 are used.  If that first word is an article (a, an,
  401.             the, etc.) or if it is only one or two characters long, you
  402.             might want to change the name before running AUTOLOG to get a
  403.             more descriptive name for the logon script.  For example, you
  404.             could change the first space to an underscore (_).  Alter-
  405.             nately, you could let AUTOLOG run, and change the file name
  406.             later, but then you have update the dialing directory too.
  407.  
  408.         ∙   You may find it necessary under some circumstances to edit
  409.             and recompile a generated logon file.  For example, you might
  410.             mess up your on-line responses.  In this case, AUTOLOG will
  411.             faithfully record whatever happens, so you would probably
  412.             want to go in and delete any mistakes.
  413.  
  414.         ∙   AUTOLOG keeps track, while on-line, of the elapsed time
  415.             between responses, and uses that information to generate
  416.             accurate waitfor() statements in the logon file.  These
  417.             timings may not be optimal, especially if the on-line program
  418.             paused a lot, so adjust them if necessary.
  419.  
  420.         ∙   If you don't like the visual bell, delete the lines that say:
  421.                 if (!_sound_on)
  422.                         call("vbell");
  423.             Or, change VBELL.SLT to do something else.
  424.  
  425.         
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456. -----------------------------------------------------------------
  457.         AUTOLOG                                                    Page 7         Registration
  458.         ------------
  459.  
  460.         I know, I know, you're saying "Why should I bother registering?"
  461.         Well, there are several good reasons:
  462.         ∙   AUTOLOG is a good program.  It will save you a lot of time
  463.             and make your life easier.
  464.         ∙   You'll feel much better if you do.
  465.         ∙   You can get source code, updates, and maybe other stuff too
  466.             (see below).
  467.  
  468.         To register, just mail me with a check for $8.00, along with your
  469.         address, phone number and E-mail address, and what kind of disk
  470.         you want (5.25 or 3.5).  If you register, I will send you a ver-
  471.         sion of AUTOLOG that doesn't have the repeating message at the
  472.         end, with complete SALT source code.  This version will also
  473.         incorporate any changes and/or improvements that I've since made
  474.         in the program.  The disk may also contain new Telix (or related)
  475.         stuff that I've written in the meantime.  For example, I'm now
  476.         working on a program to capture ANSI graphics screens with all
  477.         escape codes and save them to disk.  Also, if I update AUTOLOG
  478.         after you register, I'll send you the update free.
  479.  
  480.         In any case, I hope you enjoy the program and get some use out of
  481.         it.  I welcome all comments and suggestions.
  482.  
  483.  
  484.                                      Dave Seidel
  485.                                   9 Glenwood Blvd.
  486.                                   Hudson, NY  12534
  487.                                    (518) 828-8456
  488.  
  489.                                Compuserve: 71511,2217
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.         
  516.  
  517.  
  518.  
  519.  
  520. -----------------------------------------------------------------
  521.         AUTOLOG                                                    Page 8